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Greetings. If you're reading this, I presume that you have 
been annointed to carry forth the Electronic x'^irts logo to the Axiniga 
and beyond. Congratulations on being a. pioneer in an exciting nesv 
era for home computing. I have been working '.vith the xAiiniga 
'hands-on' for about 2 months nov/, and I assure you that this’ box 
will not become obsolete in a year. Instead, it is packed v/ith 
functionality that is rare in a micro. There is 126k of densely 
coded ROM in the box, which means lots of System support for common 
tasks. At times, I lind the sheer bulk of the infc^rmation necessary 
to make the box do something overwhelming. Ho'.Yever, all of the 
information is vital to the operation of the machine - there's just a 
lot of it. Those of you who waded through documentation from Atari 
in the early days v/ill get the same type of flavor and content from 
what's available. 

You probably had quite a bit of 6502 coding experience before 
joinings,forces with EA. That means that you probably had your own 
set of tools for 6502 develop>ment - a fast assembler," a flexible 
editor, and reasonable debugging tools. V/e at Electronic x'^xrts have 
found that most of you use different combinations of tools. Just 
think of how much experience' you could barter if everyone had used 
the same set of tools from the beginning! Well, friends, for better or 
for worse, we're trying to establish a 'standard' set of tools for 
use on the Amiga. Loosely packaged under the name 'x4rtist Work 
Station 68k', we have picked the 'must-have' tools from our infinite wish 
list, and begged, borrowed, bought or wrote the components necessary 
to have a minimal, yet functional, set of tools. Please keep in mind 
that you are among the first to use this combination of tools in an 
environment that until recently, was largely theoretical. 'We NEED 
your assessment of the system' to fold improvements back into the 
system. Please don't be afraid to be critical when criticism is 
needed. Many of the observations about its predecessor, the AxVv'S6502, 
went into the ingredients for this version, and thus AxWS68k has lots 
of neat features that x'^V/.S6502 didn't have. Your input counts. 


TO: 

FROM: 

RE: 
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Specifically, the Software components include 

1) The Editor. 

VEDIT is a full screen, programmable, user-configurable text 
editor. It's not much for formatted word pirocessing, but it’s nice 
for p-rogramming. 'v'ou may find VEDIT frustating at first, but I 
encourage you to give VEDIT a couple days before you give up on it. 

If you still feel like you’ve got to use something different, do it. 

2) The Cross-Compiler 

Amiga has contracted Lattice to make 3 versions of their 68k Compiler 

“ UNIX, IBM PC, and native. Lattice is the official sanctioned C 

for the Amiga. The version that you will be using is a Beta version. 

3) The Assembler/Linker 

’vVe’re currently using the Quelo assembler/linker, basically 
because it came with the beta copy of the C comp)iler. This is a fine 
assembler/linker package, but it's not the one that x'^^miga will be 
supporting. A company” called MetaComCo has been contracted to 
provide an assembler/linker that handles overlays. It will be 
available in the same three environments as the C compiler. Y/e will 
let you know when it’s time to switch over. 

4) The Downloader 

This is a new NWIRE downloader that runs much faster than the 
one included with x4V/S6502. x'^s a matter of fact, for those of you 
using x4‘vVS6502, you can use the same downloader included with this 
package to get faster downloads to 6502 targets. 

5) The Debugger 


The mind control device for your x4miga, a leash for your 
micro, yes fans, DDT returns in its THIRD incarnation as a debugger. 
Thanks and a tip) of the hat to Jim Dunion for his unselfish help in 
making the mutant versions of his original native x4tari debugger come 
to life. 

6) Prism 


Dan Silva’s wonderful bit map> editor includes sup)port for the 
Amiga now, so you can edit pictures on your PC and dovv’nload them to 
the Amiga. If you have a Tecmar board for the PC, you can get 
320x200 resolution with 16 colors on the PC, and then see the same 
picture on the Amiga. 
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These six components make up the guts of AVv'S68k. Pretty 
soon, we plan to have some other tools for you to add to the list, 
including a sound editing utility. In the beginning, you're on 
your osvn. If you find anything that inakes a valuable contribution to 
the synergy between these tools, let me know about it. For instance. 
I've been thinking that SideKick might be a neat addition to the 
package — you could edit your source while you're in the debugger! 
And of course, there's ah.vays that Hex calculator. 

Reading Recommendations, etc.: 

I absolutely recommend three additions to your library ■ 

* The C Programming Language - Kernighan Ritchie 

CPrentice-HalD 

Everybody says you ought to have this one, since the guy v/ho 
designed C is a co-author. Kind of bland, but a goldmine of subtlety 
concerning syntax that you'll go back to again and'” again. 

* C Primer Plus - Waite, Prata and Martin 

(Sams) 

This book is packed with examples of well-designed C code. I 
find it most helpful svhen I am truing to learn a ne'sv feature of the 
language. At times, they get carried away v/ith their delight with 
their c^.vn humor, but the book is well done. 

68000 iAxSsembly Language Programming - Kane, Hawkins, Leventhal 
(Osborne - McGraw Hill) 

This book in prominent display on your bookshelf makes it clear 
to all that you. are a serious 68000 programmer. Mostly useful for 
forgetting 6502 or 8086 mnemonics. 


I absolutely recommend one addition to your Software collection 

t Instant C - Rational Systems ($425-.$500) 

Available through your producer or Rational Systems 

This C interpreter package will let you learn C real fast on your 
AVfS. By eliminating the compiler-linker steps from your development 
loop, you can get to the algorithm that you're looking for very 
quickly. I have found this package to be indispensable for learning 
some of the subtler aspects of C. 
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Assembler vs C; 

Most of you have made your mark in the software Nvorld v/ritin 
pure assembler code. I offer you an alternative view of the future. 

If you consider C as assembly language macros, you'll start to 
appreciate its position as the Official Language of the Amiga. C 
provides you ^Yith a barebones set of functions like for-next loops, 
do-while loops, logical and boolean operators, and other necessary 
low-level stuff. After you understand the po'wer of C, if you have a 
particular function that you want to write in assembler, go right 
ahead. The interface from C to assembler is very clean and"" easy to 
implement. ^ Amiga chose to define all of the ROM calls in terms of C 
style calling descriptions. Once you get used to working in C, 
you'll thank them for their decision. If you feel yourself slipping 
to’-vards assembly as your first choice, giv^e your software buddy at EA 
a call and see if we can help you. Vour productivity '.vill absolutely 
increase as you become fluent in C. The demos th;k are being 
provided to you along svith your startup kit were 'written entirely in 
C - no assembler. 


The 'Standard' softv/are tools: 


The combination of tools that has been described comprises 
the ni-^qleus of what Amiga v/ill support as 'official' softv/are tools. 
Therefore, it is pretty important that you stick with these tools for 
the near future. There undoubtedly svill be nevy./better/improved 
alternatives to the individual components, but you 'will use them 
at your o'wn risk. We'd really like to foster an atmosphere of 
cooperative learning on this machine, and the best -way to do that is 
for all of us to share the same environment. Let me knov/ if you've 
found a better ■ solution, and we'll try to incorporate it if practical. 

HELP!!! : 

If you have problems, please feel free to contact me. I will 
attempt to solve your problem as rapidly as possible, or direct you 
to the per.son v/ho is most likely to be 'able to solve your problem. I 

can be reached from 8:30 am -^2:30 pm local time at" 415-571-7171. 
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The 'Complete' package: 

A complete A'w'S 68k envirnoment consists of the follovv’ing 
list. Make sure that you have all of the components before you start 
to do anything serious. 

1) Vour host machine, an IBM PC or approved equivalent 

2) Vour Amiga with a color monitor (analog RGB preferred) 

3) An EA-modified AxST 6 pak board 

4) NWIRE cables for IBM —> Amiga 

5) Five IBM disks 

ttl - AV/S 68k Boot Disk 

#2 - AWS 68k Runtime Disk 

#3 - PRISM 

#4 - A'w'S 68k Sample Data Disk 

#5 - Library object code modules 

6) One if^miga disk with NWIRE Target Code 

7) A packet of memos, covering: 

ttl - Bootstrapping the AWS 68k Environment 

#2 - Building the Sample C File, SIMPLE.C 

«3 - Using DOWNLOAD and DDT 

#4 - Using PRISM 

45 - Printouts of the DDT Help Screens 

8) An RS-232 cable for connecting A'a-'S ~> Amiga for bootstrap 

A firm handshake . . . 

To start up your system, read the memo entitled 
'Bootstrapping the AxV/S 68k Environment'. Once you have started the 
Axiniga, proceed to 'Building the sample C file, SIMPLE.C. Then, move 
on to 'Using DO'v'vNLOAD and DDT'. If you've gotten this far, you're 
•well on your Nvay to becoming a x^xiniga soft'ivare artist. 

Once again, congratulations on being selected to create an 
Amiga product for Electronic xA^rts. We look forv/ard to a monster hit 
from you. Go forth and code. 


TO: Amiga Artists 

FROM: Greg Riker COHFIDEIIIIAl 

DATE: 9 January 1985 

RE: Bootstrapping the AVv'S 68k Environment 


In order to bootstrap your Amiga, follow this sequence : 

1) Place the WWS 68k Boot Disk' in Drive A:. If the power is 

off, turn on your AVv’S. If the power is already on, press 
Ctrl-Alt-Del to reboot your AVVS. 

2) x^xfter the boot sequence has finished, type : 

'a:‘ to make a: the" default drive. 

'cd pc-talk' to enter the directory containing PC-TALK. 

•pc-talk' to run PC-TALK. 

3) A full screen of PC-TALK text appears, follosved by a prompt at 

the bottom that says 'press any key ... Press the space bar 
to continue. 

4) The screen clears, and some information about PC-TALK appears in 
the upper right hand corner. Press ALT-C to clear the screen. 

The default parameters that PC-Tx-\LK uses are correct for the 
Amiga as of this writing. PC-Tx4LK is configurable to other 
settings if necessary. Call me if you need help -with this. 

5) Verify that your Amiga and your AV/S are connected with an 

RS-232 cable through the serial ports. On the Amiga, there is a 
DB-25 port labeled 'UART'. On the x'^^xWS, the DB-25"’port on the AST 
6-Pak board is the serial port. 

6) Verify that your NVv'IRE cable is connected bet^Yeen the x4Vv'S and 

x^xiniga. 

7) Power up the Axiniga. You will see a message on the PC-TALK screen 

from the Amiga, there will be a pause, the screen will turn to 
blue and black stripes, and then more text from the Amiga v/ill 
appear on the PC-TALK screen. The environment that you are 
talking to is the ROM debugger in the Amiga. 

8) Type 'g c ffOOOO' (no spaces, added here for clarity). This 

tells the Amiga to pass control to the internal MiniFileSystem. 

Insert your Amiga Boot Disk into the disk drive, and close the 
door. 


Type 'b' 
Type 'Is' 
Type 'nwire' 
Type 'q' 


to boot the disk. 

to see the files on your x^xmiga Boot Disk, 
to load the N'vYIRE Target Code into memory, 
to exit the MiniFileSystem. 
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IMPORTANT NOTE: This is NOT the file system that will be 
delivered for the system. It is a temporary solution that allo',YS 
developers to keep code and data on a local disk. It is designed 
for bootstrap and demo purposes only. The real file system svill 
be just that - a real file system. Don't worry about learning 
all of the ins and outs of this one. 

9) S'ou are now back in the ROM Debugger. 

Type 'gc7f000' to start the A'v'v’.S 68k target code. 

The AV-/S 68k Target code is now executing. You won't see any 
confirmation from the Amiga, because the AVYS 66k Target Code is 
in control now. If you do see some sort of a message, you've 
probably blown it somewhere along the line. Start over at step 7. 

10) If all is well : 

Type 'ALT-X' to exit PC-TALK 

Type 'y' to confirm that you really want to leave 

PC-TALK. 

11) MS-DOS reloads COMMAND.COM from drive A-., and you're ready to talk 

to your Amiga via DCWv'NLOAD and DDT. 
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TOi Amiga Artists 

FROM: Greg Riker 

RE: Building the sample C file, SIMPLE.C 

DATE: 9 January 1985 


This is a summary of how to build an executable image of 
SIMPLE.C. Vou will find all of the files necessary to build SIMPLE 
on the disk entitled 'AWS 68k Sample Data Disk'. 

1) Make sure that the 'AV/S 68k Runtime Disk' is in Drive A:. 

2) Make sure that the 'A'v-fS 68k Sample Data Disk' is in Drive B:. 

3) Make the default drive C: by typnng 'c:' 

4) Copy SIMPLE.C and SIMPLE.LNK from drive B: to drive C:. 

Type 'copy b:Simple.c' to load the C source code for SIMPLE 

Type 'copy b:simple.lnk' to load the linker control file for SIMPLE 

5) Type 'xc simple' to invoke the cross-compiler 

This step will take about two minutes. Vou can monitor the 
progress of the cross compilation by watching the various 
messages that come up on the screen. Obviously, SIMPLE is more 
than a few lines of code!. At the end of the cross-comp>ile, 

-SIMPLE.LTX is backed up to drive B:. Files ending in .LTX are 
object code modules output by the cross-compiler "or assembler. 

6) Type 'copy b:*.ltx' to load the object modules for SIMPLE 

These files correspond to the contents of the .LNK file. They 
comprise the Amiga ROM interface code, and some C library " 
functions. 

Type 'link simple' to begin the link process 

If all goes well, you'll have no errors from the link, and you 
will be told that SIMPLE.SVM and SIMPLE.S28 have been backed up 
to drive B:. 


7) 
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8) Type 'dir simple' 

to see all of the SIMPLE files 


Vou'll see five files 


SIMPLE.C 

SIMPLE .LNK 

SIMPLE LTX 

SIMPLE.S'v'M 

SIMPLE,S28 

the original C source code 
the Linker Control File 

SIMPLE'S object _ code module 
the symbol table for SIMPLE 
the executable code of SIMPLE 

9) You have just built a program! 



10) Go to the memo entitled 'Using DOVVNLOx^D and DDT' to run the demo 
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TO: Amiga Users 

FROM: Greg Riker 

RE: Using DOWNLOAD and DDT 

DATE: 9 January 1985 

Before you can dov/nload or debug a file, the Amiga must have 
been bootstrapped so that the AW'S 68k Target Code is currently 
running on the Amiga. See the memo titled "Bootstrapping the'^ AVv'S 68k 
Environment" for instructions on hov/ to bootstrap the x'^rniga. 

Vpu must also have a .S28 file to download. For this demo, I 
assume that you have built the SIMPLE.S28 file by following the 
instructions in the memo titled "Building the Sample C File, 

SIMPLE.C". 

1) Verify that the 'AV-/S 68k Runtime Disk' is in Drive A:. 

2) Verify that the files SIMPLE.S28 and SIMPLE.SVM are on Drive C:. 

3) Verify that Drive C: is the default drive. 

4) Type "download simple .s28" to download the executable code 

Vou will see the addresses to which the downloader is 
loading, then a line of dots. Each dot represents one line of 
the S28 file. Note the Run Address that is specified at the end 
of the download — this is the Run Address (where 'main' is) in 
your C code. 

5) Type "ddt simple .sym" to invoke DDT with the symbol table 

from SIMPLE.C 

The DDT screen will come up, and the Main Vv’indov/ will show code 
disassembled in ROM. This is the re-entry point for the ROM 
debugger. 


6) 

Type 


to see a summary of the commands 
and their syntax 

7) 

Type 

"B" 

to learn more about breakpoints 

8) 

Type 

<space bar> 

to return to the disassembly window * 

9) 

Type 

"E 'main'" 

to look at the code at 'main' 

8) 

Type 

"R PC,2005A’ 

to .set the PC to the address of 
'main'. 


CDWHEIimt 

9) Use the cursor keys to page up and down through the code. You 

will see lots of calls to interesting sounding routines. Get 
familiar with the effect of each cursor control key, including 
PgUp and PgDn. 

10) Type "W to toggle the display window to HEX ^ 

ASCII 

11) Type "Vf to toggle back to the disassembly 

window 

12) Type "E to return the window to the current 

PC 

13) Type using the large V key at the extreme right side of the 

keyboard. One instructioivwill execute, and the screen will 
update with the new values. Single step 3 more times until you 
get to the jSR OpenLibr instruction. 

14) Type "P" to treat the next instruction as a 

Procedure. 

The PROCedure instruction sets a breakpoint after the current 
instruction, and then runs the code at the current PC. This is 
just what you want to treat JSR’s as a single instruction. You 
may use "P“ anywhere you v/ould use but note that using a "P" 
command at a Bxx instruction will not .give you control back until 
execution reaches the next instruction past the Bxx instruction. 

This is a good way to get out of a loop quickly. 


15) Look at the listing for SIMPLE.C. On the second page, just under 
'mainO' is a C instruction:. 

GfxBase = (struct GfxBase *) OpenLibrary("graphics",0); 

Look at the DDT screen. The instruction at 20064 reads : 

PEA.L $20F4C 

Type 'E 20F4C, and then change the display windcw to the 
HEX/ASCII mode. In the A/SCII window, there is a string, 
"graphics". This is an argument to the OpenLibrary function call 
from C. V/hen you see a JSR to a named routine in the 
disassembly window, you can usually correlate it to a line of C 
source code. The next JSR instruction at address 20084 is to a 
routine called LoadClrs. If you look at the C source code, 
you'll find that C instruction 2 lines after the call to 
OpenLibrary. 
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16) Type "G *" to run the code at the current PC. 

Vou should see a yellow "0" from the EGA logo bouncing around on the 
screen. On the DDT screen, in the command window, you will see a 
message that tells you to press any key to stop execution in the 
target. 

17) Type <space bar> to stop the Amiga 

The "0" figure may or may not be displayed when you stop the 
machine, depending on where the code was when it -was interrupted. 

18) Type "T" to invoke the Trace Options menu 

Use the arrows and space bar to highlight the follosving options: 

Instruction V/indow 

Stack 

Registers 

Type <CR> to accept the highlighted options and return to the 
disassembly screen. 

19) Type T to run the code Interpretively, displaying the trace 

options that you selected in step 12. 

20) Vou will see the code executing an instruction at a time, with 

screen updating the Instruction SVindoNv, the Stack, and the 
Register display after each instruction. At this speed, you 
won't see Amiga screen activity very often. 

21) Pre^s any key to stop Interpreted execution. 

22) Type "T" to invoke the Trace Option menu 


This time, select High Speed. High Speed mode is mutually 
exclusive with all of the other display mode options, so they 
■•.Yill be turned off automatically for you. Press <CR> to accept 
and return to the disassembly" window. 

23) Type "I" to run the code in the High Speed Interpreted mode. 

If the ball is moving at normal speed, the High Speed invocation 
didn't 'take'. Press any key to interrupt the target, then press 
"I" to restart. Keep doing this until the ball is ""moving very 
slowly, appe'aring and disappearing on the screen. For an 
explanation of this phenomenon, read on. If you're not 
interested, skip forward to step 24. 

How the High Speed Mode works: 

The 68000 has a mode called the Trace Mode, v/hich is invoked by 
setting the Trace Bit (bit 15) in the Status Register. On the 
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DDT screen, this bit is shown with the letter T' on the far left 
of the status bit display. V/hen the Trace bit is set, execution 
is interrupted after each instruction, and control is passed 
through a vector to a routine that causes a variable delay. 
Pressing the left and right arrow keys causes DDT to actually 
write a new delay value into the routine. In this fashion, you 
can control the effective execution speed of the machine over a 
wide range. Occasionally, when you invoke the High Speed mode, 
it doesn't 'take'. This occurs svhen you interrupt tiio machine in 
the middle of an interrupt routine. DDT faithfully sets the Trace 
bit, but ••■vhen the end of the interrupt routine comes along, the 
status registers are popped off the stack, clearing the Traxe bit 
that v/as just set! I don't have a foolproof solution for this 
problem, so follosv the procedure outlined above — stop the 
target,, and reissue the "I" command until the speed slows. I 
find that this rarely takes more than 3 attempts. 


24) Type and to change the execution 

speed 

25) Type <space bar> to stop the target 

26) Now, we will use the mini-symbol table feature of DDT. 

Type “E 'vx'" to examine the X velocity 

component of the movement 

Type "E 'vy'" to examine the V velocity 

component of the movement 

Note the addresses of these variables. You can track the 
contents of these variables with the M command, which Monitors 
locations in Target memory. 

Type "M 2,xxxxx<CR>" to tell DDT the address of 

the word variable 'vx'. 

The cursor ••.vill go the top line of the mini-symbol table, where 
DDT is waiting for you to type in the name of the variable that 
we're monitoring. 

Type "VX" to name it "VX" 

In a similar way, monitor the location of 'vy'. 

Type "M 2,xxxxx<CR>" 

Type "VY" 
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27) In the far right column labeled Value', the current contents of 

VX and VY are displayed in word format. To change the velocity 
components : 


Type "E 'vx'" 

Type "D 0020<CR>“ 
Type "G *" 


to position the window 
to change the x velocity 
to watch the new speed 


Type <space bar> 


to stop the target 


Type "E 'vy'" 

Type "D 0001<CR>" 
Type "G *" 


to position the window 
to change the y velocity 
to svatch the new speed 


28) Well, you’ve done it. You have built an executable C image 

on your AWS, downloaded it into the Amiga, and controlled the, 
execution of it. Now, it's up to you to be brilliant. 
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/* simple.c: One moving bob colliding with walls. 
#define BORDERHIT BNDRY^HIT 
#include <5td.h> 

<dudio. h> 


♦/ 


#include 
^include 
tinclude 
^include 
#include 
^include 
tinclude 
#include 
tinclude 
tinclude 
tinclude 
tinclude 
tinclude 
tinclude 
tinclude 


<blit.h> 

<col1ide- h> 
(copper. h> 
(display. h> 
(dma. h> 

(gels-h> 
(gfx.h) 
(gfxblit.h) 
(gfxmacros. h> 
(exstruct- h> 
(graph-h> 
(gfxbase- h> 
(int.h) 

(regs.h> 


CONFiOEHIliy. 


tdefine SHEIGHT 2B 
tdefine SWIDTH 2 
tdefine SDEPTH 1 

tdefine WIDTH 320 
tdefine HEIGHT 200 
tdefine DEPTH 4 

tdefine FOREVER for(;;) 


/* vSprite height */ 
/* vSprite width */ 
/* vSprite depth */ 

/* screen width */ 

/* screen height ♦/ 
/* screen depth */ 


/* general usage pointers 
struct GfxBase *GfxBase; 
struct View v; 
struct Viewport vp; 
struct Gelsinfo gelsinfo; 


struct RastPort *writePort = 0; 
struct RastPort rP; 
struct IVPfirgs viewPrgs; 
struct vSprite durnSpriteCEl = -(©T; 


struct vSprite sprite = <0>; /* 
struct bob bob = {0>; /* 
int vx, vy; /♦ 
short imaDe0 CSDEPTH*SHEIGHT*SWIDTH3 
0 , 0 , 0 , 0 , 

0x0, 0x0, 0X07FF, 0XFFF0, 
0X3FFF, 0XFFFC, 0x7FC0, 0x0, 

0xFFC0, 0X0000, 0X0, 0X0, 

0X0, 0X0, 0XFFFF, 0XFFFF, 
0X7FFF, 0XFFFE, 0x3FFF, 0x0000, 
0X07FF, 0xF000, 0X0, 0X0, 


vSprite info for the sphere. 
Bob info for sphere.*/ 
Sphere’s velocity.*/ 

= -C /* sphere image.*/ 

0X003F, 0xFF00, 0X01FC, 
0X1FC0, 0X0, 0X0, 

0x0, 0x0, 0X7FFF, 

0XFFFF, 0XFFFF, 0xFFE0, 
0x7FF8, 0x0000, 0x0, 
0x0, 0x0, 0X1FFF, 

0X01FF, 0XFF00, 0X003F, 


*/ 


0X0, 

0X0, 

0XFFFE, 

0X0000, 

0X0, 

0XFFF0, 

0XFC00 >; 


short colorsC3E3 = i 
0X000, 0X0ff, 
0X000, 0X000, 
0X000, 0X000, 
0X000, 0X000, 


/* Each color is: 0x—blue-green~red */ 


0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0Xfff, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0X000, 

0xfff 


/* Copy array contents: long destinationCnLongsl = sourceC3.*/ 
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CopyOfLongsCdestination, source, nLongs) 
register long *destination, ^source; 
register int nLongs; < 

do *C *destination++ = *source++; > while (—nLongs); > 


/* routine called when a border collision is detected 
borderPatrol(s, b) struct vSprite *s; int b; < 
if (b & (TOPHIT I BOTTOMHIT)) vy = “vy; /* Reverse direction.*/ 
if (b & (LEFTHIT I RIGHTHIT)) vx = -vx; > 


mainO -C 
register int i; 
struct Gelsinfo *gi; 
long *5ptr; 

char *pptrEDEPTHl, *rptrCDEPTH3; 
short next lines[81, *lastcolor5[81; 
struct colliable smash; 

GfxBase = (struct GfxBase *)OpenLibrary("graphics",0); 

GfxBase-)Debug =0; 

LoadClrs(colors); 

writePort = &rP; 

InitRastPort(writePort, WIDTH, HEIGHT); 
rP.Planes = &pptrC01; 
rP.Depth = DEPTH; 

for (i = 0; i < DEPTH; i++) pptrCil = (char *)flllocRaster(WIDTH, HEIGHT) 
Set Rast(writ ePort, 0); 

InitView(&v); 

V. Gelsinfo = gi = &gelsinfo; 

gi->nextLine = &nextlinesC01; gi->lastColor = &la5tcolors[01; 

gi-> leftrnost = gi->topmost = 0; 

gi->rightmost = WIDTH - 7; gi->bottommost = HEIGHT - 1; 

gi->coIlHandIer = ^smash; gi->5prR5rvd = -1; 

v.ViewPort = &vp; 

viewArgs.DHeight = viewPrgs.RHeight = HEIGHT; 
viewPrgs.DWidth = viewflrgs.RWidth = WIDTH; 
viewPrgs.DxOffset = viewPrgs.DyOffset = 0; 
viewfirgs.RxOffset = viewPrgs.RyOffset = 0; 
viewPrgs.Modes = 0; 

Init\rT^rt (£vp, &viewPrgs} ; 

vp.Planes = Spptr[01; 

vp.Depth = DEPTH; 

vp.Mask = 0>:3F >> (8 - DEPTH); 

vp. Next = NOLL; 


NewView(&v); 

InitGels (&dum3priteL01, SdurnSpriteCll) ; 
SetCollisionfBORDERftlT, SborderPatrol); 

Sprite.X = 130; sprite. y = 50; 

sprite-vSFlags = SPVEBPCK I OVERLPY; 
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sprite.height = SHEIGHT; sprite, width = SWIDTH; 

sprite.depth = SDEPTH; 
sprite. rneMask = sprite. hitMask = 1; 

I* make a work copy of the image */ 
sprite. irnageData = (short *) getmern (sizeof (irnaQB0)) ; 

CopyOfLongs (sprite. imageData, imaQe0, sizeof (irr.ag00) / sizeof (long)); 

initialize boundary collision mask ♦/ 
sprite. borderLine = (short *) getrnern (4) ; 
sprite, col lMask= (short *)getrnemO * SHEIGHT * SWIDTH); 

InitMasks(Ssprite); 
sprite. sprColors = 0; 

Selects 1 plane of image as data for Plane 0 of RastPort.*/ 
sprite.planePick = 0 k01; 

/* Selects all bits off for other Planes of RastPort.*/ 

sprite.planeOnOff = 0x00; 

vx = 3; vy = 4; 

sprite. vSBob = S:bob; 

bob.bobVSprite = ^sprite; 

bob.imageShadow = sprite.colIMask; 

bob. saveBuf fer = (short *)getrnern(2 * SHEIGHT ^ SWIDTH ♦ DEPTH); 

bob. savePlanes = &rptrE03; 

bob.before = bob. after = 0; 

bob. bobFIags = 0; 

bob. bobCorap = 0; 

bob.dBuffer = 0; 

AddBob(Sbob); /* Append bob to display list.*/ 

MrgCop(^v); WaitBlit(); LoadView(&v); 

FOREVER < 

sprite.X += vx; sprite.y += vy; 

SortGListO; DoCollisionO ; WaitTOFO; DrawGList (writePort) ; T 

> 

static short dummy; /* force alignment to even byte at end of file’s data */ 



DDT Help Screens 


B <bkpt #>,<address><CR> BREAKPOINTS 

Breakpoints are set by typing 'B'^ the number 
a delimiter^ and the address in RAM 
where you would like the breakpoint set. ROM 
breakpoints are legal in INTERPRET mode. When a 
breakpoint is encountered, execution is halted 
and the screen will update to the address of 
the breakpoint. To clear an active breakpoint, 
type 'B <#>,<CR>^. You may update a breakpoint 
to a new address without clearing the old value 
first. Breakpointed instructions are shown in 
inverse video. 

B 1,4000 - Set a brkpoint at S4000. 

B 2,> -.Set a brkpoint at display address. 

C CONTINUE 

The Continue function is a combination of the 
Breakpoint and Go commands. Issuing a ’’C** 
causes a single step past the current 
instruction, then a breakpoint to be placed at 
the instruction just executed, then a Go 
command. When (if) control returns to the 
address where the breakpoint was left, 
execution is halted. This command is most 
useful in loops. The breakpoint used is #0, 
and ma>^ be cleared manually. It is cleared 
automatically by a user-issued Go command. 

D <byte><byte><CR> -or- D 'text<CR> DEPOSIT 

This function deposits bytes into Target 
memory at the currently displayed address. 

The *‘byte'* is entered in the form of ASCII 
nybbles. To deposit $15, type **D 15”. You 
may enter up to 8 bytes at once. You may also 
enter bytes in ASCII form. Type ”D'Hello<CR>”. 
If you are in the Hex/ASCII window, the 
displayed position is advanced by the number 
of bytes that you deposit. If you are in the 
Instruction window, the display is not 
advanced. 


D 48856C6C6F<CR> -or- D 'Hello<CR> 


COHFIDEnillL 


E <addreaa><CR> -or- E 'label<CR> EXAMINE 


Examine allows you to move the display window 
to any address in memory. The contents of the 
location are displayed in the current WINDOW 
mode. You may toggle the current window format 
with the WINDOW key. To move up and down 
through memory^ use the cursor control keys. 
Left/Right keys shift the window by a word. 
Up/Down keys shift the window by a line- PgUp 
PgDn keys shift the window by a screen. 


E 4000<CR> - Examine memory at S4000 

E 'main<CR> - Examine memory at ''main' 


G <addr><CR> GO 

Go passes control to the Target machine at the 
specified address. There are two shorthand 
notations that may be used with GO. The 
key is an alias for the current PC and a <CR>. 
The *•>•• key (unshifted) is an alias for the 
current window display address and a <CR>. 


G 4000<CR> - Go at S4000 

G » “ Go at current PC 

G > - Go at current display address 

I INTERPRET 

INTERPRET has two modes. In the 'High Speed' 
mode, you have control over the speed of 
execution, but there is no display updating. 

In the 'Low Speed' mode, you may select which 
of the dynamic screen areas you wish to have 
updated- (See TRACE OPTIONS). In either mode, 
execution continues until : 

* You press a key 

* A Trap address is encountered (Low Speed) 

* A marked Variable is changed (Low Speed) 
When execution halts, the screen is updated- 


M <range, base addresa><CR> 


MONITOR 


The MONITOR function allows you to name and 
monitor specific memory locations in the Target 
machine. The range parameter defines the range 
of memory locations from the base address that 
are considered part of the named location. To 
define a word variable at 5000, you would enter 
**M 2,5000<CR>'’. The cursor is then placed into 
the Label Window, and you may enter the name of 
the variable (up to 8 characters). To toggle 
between addresses and values, type 'M <CR>'. 
Range Parameters: 

0~Routine 1-Byte 2-Word 

P PROCEDURE CALL 

The PROC command deposits a breakpoint at the 
next instruction in memory after the current 
one, and issues a Go command. This is useful 
when you wish to execute subroutines as single 
steps. Note that you should not use 'P' to 
execute an RTS type instruction. Be careful 
when you use it with a Bxx instruction. PROCs 
don't work in ROM. 


ESC ESCAPE 

Escaping the debugger exits to MS-DOS. The 
Target is left in its current state. You may 
leave a program running after executing a GO 
command, re-enter DDT and stop the program. 
Symbols defined in the mini-symbol table are 
lost. 


R <register,value> REGISTER 

The *'R*'egister command allows you to change the 
contents of the D Registers, the A Registers, 
the User and Supervisor Stacks, and the PC. 
Changing the PC allows shorthand notation, 
is an alias for 'R PC'. 


R DO,1234 <CR> - Register DO = 1234 
R SS,20000 <CR> - Supervisor Stack = 20000 
R SR,2300 <CR> - Status Word = 2300 
» > <CR> - PC = current display address 


CONFIDEIHIAL 

s SYNC 

The SYNC command causes the Target to resync 
with the host. The Debugger screen is updated 
after refreshing all of the dynamic 
information. This is useful if the Target is 
out of control^ and the NWIRE code has not 
been smashed. A Interrupt will be issued if 
the Target does not respond to SYNC request. 

Then^ another SYNC request will be attempted. 

If the Target is unreachable, the Target ID 
will be replaced with a flashing 'DEAD!' 
message. 


T TRACE OPTIONS 

Setting Trace options allows you to select 
High or Low speed execution during Interpreted 
execution. You may select High Speed, which 
does no display updates or breakpoint 
checking. Execution speed is then controlled 
with the left & right cursor keys. 

Alternatively, you may select any combination 
of Instruction Window, Stack, Registers and 
Symbol updating. High Speed and Display 
Updates are mutually exclusive. Don't use 
'Call User Proc' unless you know what you're 
doing with it. 


V < - > < > VARIABLE 

You mark a variable by pressing the ''Variable 
key, which places the cursor in the Variable 
window. To maneuver to the variable that you 
want to mark, use the return key. To mark a 
variable, use the or the "V" keys. To 

unmark a variable, use the space bar. When a 
marked variable has been changed, a replaces 

the Marked variables changed during a Go, 

Continue, or JSR command are flagged with the 

character, but execution is not halted upon 
the event. Variables changed in the Interpret 
mode cause execution to stop. 


W WINDOW 

Pressing the "Window key causes the Display 
Screen to toggle between the HEX/ASCII window 
and the Instruction Disassembly window. 


Table 1-2. Instruction Set 


Table 1-1. Data Addressing Modes 


68000 


Mnerr>onic 

Description 

ABCD 

Add Decimal with Extend 

ADD 

Add 

AND 

Logical And 

ASL 

Arithmetic Shift Lett 

ASR 

Arithmetic Shift Right 

Bcc 

Branch Conditionally 

BCHG 

Bit Test and Change 

BCLR 

Bit Test and Clear 

BRA 

Branch Always 

BSET 

Bit Test and Set 

BSR 

Branch to Subroutine 

BTST 

Bit Test 

CHK 

Check Register Against Bounds 

CLR 

Clear Operand 

CMP 

Compare 

DBcc 

Test Condition, Decrement and Branch 

DIVS 

Signed Divide 

DIVU 

Unsigned Divide 

EOR 

Exclusive Or 

EX6 

Exchange Registers 

EXT 

Sign Extend 

JMP 

Jump 

JSR 

Jump to Subroutine 

LEA 

Load Effective Address 

LINK 

Link Stack 

LSL 

Logical Shift Left 

LSR 

Logical Shift Right 

MOVE 

Move 

MOVEM 

Move Multiple Registers 

MOVEP 

Move Peripheral Data 

MULS 

Signed Multiply 

MULU 

Unsigned Multiply 

NBCD 

Negate Decimal with Extend 

NEC 

Negate 

NOP 

No Operation 

NO 

Ones Complement 

OR 

Logical Or 

PEA 

Push Effective Address 

RESET 

Reset External Devices 

ROL 

Rotate Left without Extend 

ROR 

Rotate Right without Extend 

ROXL 

Rotate Left with Extend 

ROXR 

Rotate Right with Extend 

RTE 

Return from Exception 

RTR 

Return and Restore 

RTS 

Return from Subroutine 

SBCD 

Subtract Decimal with Extend 

See 

Set Conditional 

STOP 

Stop 

SUB 

Subtract 

SWAP 

Swap Data Register Halvf^ 

TAS 

Test and Set Operand 

TRAP 

Trap 

TRAPV 

Trap on Overflow 

TST 

Test 

UNLK 

Unlink 



Hex and Decimal Conversion 

ei334St7ltABCDEF 


• 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0 

1 

16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 

1 

7 

32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 

2 

3 

48 4 9 50 51 52 53 54 55 56 57 58 59 60 61 62 63 

3 

4 

64 65 66 67 68 69 70 7l 72 73 74 75 76 77 78 79 

4 

S 

80 81 82 83 84 85 86 8 7 88 89 90 91 92 93 94 95 

S 

• 

96 97 98 99 lOO 101 102 103 104 105 106 107 108 1 09 110 ill 

6 

7 

112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 

7 

• 

128 129 130 131.132 133 134 135 136 137 136 139 140 141 142 143 

■ 

• 

144 145 146 147 146 149 150 151 152 153 154 155 156 157 158 159 

9 

* 

160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 

A 

» 

176 177 176 179 180 I8i 182 183 184 185 166 187 168 189 190 I9i 

B 


192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 

C 

m 

208 209 210 211 2l2 213 214 215 216 217 218 219 220 221 222 223 

O 

$ 

224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 

E 

• 

240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 

F 


01234S6789ABCOEF 



Mode 

Generation 

Register Direct Addressing 

Data Register Direct 

Address Register Direct 

EA= Dn 

EA= An 

Absolute Data Addressing 

Absolute Short 

Absolute Long 

EA=(Next Word) 

EA= (Next Two Words) 

Program Counter Relative Addressing 
Relative with Offset 

Relative with Index and Offset 

EA=(PC) + di6 
EA={PC)+(Xn) + d8 

Register Indirect Addressing 

Register Indirect 

Postincrement Register Indirect 
Predecrement Register Indirect 

Register Indirect with Offset 

Indexed Register Indirect with Offset 

EA=(An) 

EA=(~n). An —An+N 
An— An-N, EA=(An) 
EA= : ^n) di5 

EA= .-n) + (Xn) + d8 

Immediate Data Addressing 

Immediate 

Ouick Immediate 

DATA - Next Word(s) 
Inher*- t Data 

Implied Addressing 

Implied Register 

EA=i ^ USP, SP. PC 


NOTES: 

EA='Effective Address 
An = Address Register 
Dn = Data Register 

Xn= Address or Data Register used as lr>dex Register 

SR = Status Register 

PC= Program Counter 

d8 = 8-bit Offset (displacement) 

dl6= 16-bit Offset (displacement) 

N = 1 for Byte. 2 for Words, and 4 for Long Words. 

If An is the stack pointer and the operand size it 
byte. N = 2 to keep the stack pointer on a word 
boundary. 

( ) = Contents of 
*— = Replaces 


CC — Carry Clear 
CS — Carry Set 
EQ — Equal 
F —Never True 
GE — Greater or Equal 
GT — Greater Than 
HI — High 
LE — Less or Equal 

LS — Low or Same 
LT — Less Than 
Ml — Minus 
NE — Not Equal 
PL — Plus 
T —Always True 
VC — No Overflow 
VS — Overflow 



Table 1*3. Variations of Instruction Types 


Instruction 

Type 

Variation 

Description 

ADD 

ADD 

Add 


ADDA 

Add Address 


ADDQ 

Add Quick \ 


ADDI 

Add Immediate | 


ADDX 

Add with Extend ] 

AND 

AND 

Logical AND 


ANDI 

AND Immediate 


ANDI to CCR 

AND Immediate to Condition Code 


ANDI to SR 

AND Immediate to Status Register 

CMP 

CMP 

Compare 


CMPA 

Compare Address 


CMPM 

Compare Memory ! 


CMPI 

Compare Immediate { 

EOR 

EOR 

Exclusive OR i 


EORI 

Exclusive OR Immediate 


EORI to CCR 

Exclusive Immediate to Condition Codes 


EORI to SR 

Exclusive OR Immediate to Status Register 

MOVE 

MOVE 

Move 


MOVEA 

Move Address 


MOVEQ 

Move Quick '■ 


MOVE to CCR 

Move to Condition Codes | 


MOVE to SR 

Move to Status Register j 


MOVE from SR 

Move from Status Register | 


MOVE to USP 

Move to User Stack Pointer \ 

NEG 

NEG 

Negate i 


NEGX 

Negate with Extend | 

OR 

OR 

Logical OR 


ORI 

OR Immediate 


ORI to CCR 

OR Immediate to Condition Codes 


ORI to SR 

OR Immediate to Status Register 

SUB 

SUB 

Subtract 


SUBA 

Subtract Address 


SUBI 

Subtract Immediate 


SUBQ 

Subtract Quick 


SUBX 

Subtract with Extend 





















































































Table 5*2. Exception Vector Assignment 


Table A-1. Condition Code Computations 


Vectof 

Number(s) 

Dec 

Address 

Hex 

Space 

Assignment 

0 

0 

000 

SP 

Reset; Initial SSP2 


4 

004 

SP 

Reset: Initial PC2 

2 

8 

008 

SD 

Bus Error 

3 

12 

OOC 

SO 

Address Error 

4 

16 

010 

SD 

Illegal Instruction 

5 

20 

014 

SD 

Zero Divide 

6 

24 

018 

SD 

CHK Instruction 

7 

28 

01C 

SD 

TRAPV Instruction 

8 

32 

020 

SD 

Privilege Violation 

9 

36 

024 

SD 

Trace 

10 

40 

028 

SD 

Line 1010 Emulator 

11 

44 

02C 

SD 

Line 1111 Emulator 

12l 

48 

030 

SD 

lUnassigned. Reserved) 

13l 

52 

034 

SD 

lUnassigned, Reserved) 

14l 

56 

038 

SD 

lUnassigned. Reserved) 

15 

60 

03C 

SD 

Uninitialized Interrupt Vector 

16-231 

64 

040 

SD 

lUnassigned. Reserved) 

95 

05F 


- 

24 

96 

060 

SD 

Spurious Interrupt^ 

25 

100 

064 

SD 

Level 1 Interrupt Autovector 

26 

104 

068 

SD 

Level 2 Interrupt Autovector 

27 

108 

06C 

SD 

Level 3 Interrupt Autovector 

28 

112 

070 

SD 

Level 4 Interrupt Autovector 

29 

116 

074 

SD 

Level 5 Interrupt Autovector 

30 

120 

078 

SD 

Level 6 Interrupt Autovector 

31 

124 

07C 

SD 

Level 7 Interrupt Autovector 

32-47 

128 

080 

SD 

TRAP Instruction Vectors^ . 

191 

OBF 



48-631 

192 

OCO 

SD 

lUnassigned, Reserved) 

255 

OFF 


- 

64-255 

256 

100 

SD 

User Interrupt Vectors 

1023 

3FF 


- 


NOTES; 


1. Vector numbers 12, 13. 14, 16 through 23. and 48 through 63 are re¬ 
served for future enhancements by Motorola. No user peripheral devices 
should be assigned these numbers. 

2. Reset vector (0) requires four words, unlike the other vectors which only re¬ 
quire two words, and is located in the supervisor program space. 

3. The spurious interrupt vector is taken when there is a bus error indica¬ 
tion during interrupt processing Refer to Paragraph 5 5 2. 

4. TRAP in uses vector number 32 + n. 


Operations 

X 

N 

z 

V 

c 

Special Definition 

ABCD 

• 

U 

? 

u 

? 

C= Decimal Carry 

Z = Z» Rm» ...‘RD 

ADD, ADDI, 
ADDQ 

• 

• 

• 

? 

? 

V= Sm-Dm»Rm-h Sm»Dm*Rm 

C= Sm-Dm-f- Rm»Dm-»- Sm»Rm 

ADDX 

• 

• 

? 

? 

? 

V = Sm»Dm» Rm Sm»Dm«Rm 

C= Sm«Dm-h Rm«Dm-f Sm»Rm 

Z = Z»firn«...-RQ 

AND. ANDI. 

EOR, EORI, 
MOVEQ, MOVE, 
OR. ORI, 

CLR, EXT. 

NOT, TAS, TST 


• 

• 

0 

0 


CHK 

- 

» 

u 

u 

u 


SUB, SUBI 
SUBO 

• 

« 

• 

? 

? 

V= Sm»Dm«Rm-f- Sm»Dm»Rm 

C= Sm-Dm-t- Rm»Dm-h Sm»Rm 

SUBX 

• 

« 

? 

? 

? 

V = Sm»Dm*Rm Sm»Dm»Rm 

C= Sm-Dm-f- Rm»Dm-»- Sm»Rm 

Z = Z.Rm.....R0 

CMP. CMPI, 
CMPM 

- 

« 

* 

? 

? 

V= Sm*Dm»Rm-f- Sm«Dm*Rm 

C= Sm»Dm-f- Rm-Dm-f- Sm*Rm 

DIVS, DIVU 

- 


* 

? 

0 

V = Division Overflow 

MULS, MULU 

- 

« 

* 

0 

0 


SBCD, NBCD 

* 

U 

? 

u 

? 

C= Decimal Borrow 

Z = Z« Rm»... • RO 

NEC 

* 

* 

• 

? 

? 

V=Dm*Rm, C=Dm-hRm 

NEGX 

« 

» 

? 

? 

? 

V=Dm«Rm, C=Dm-»-Rm 

2 = Z«Rm-...«R0 

BTST, BCHG. 
BSET, BCLR 

- 

- 

? 

- 

- 

Z=Dn 

ASL 


« 

* 

? 

? 

V= Dm»IDm- !-«■... + Dm-f) 

-f-Dm.lDm-1 + ... + Dm-r) 

C = ^m - r + 1 

ASL lr = 0) 

- 

* 

« 

0 

0 


LSL, ROXL 

• 

* 

• 

0 

? 

C= Dm - r-»-1 

LSR lr = 0) 

- 

* 

« 

0 

0 


ROXL lr = 0) 

- 

♦ 

* 

0 

? 

C = X 

ROL 

- 

• 

* 

0 

? 

C = Dm- r-f-1 

ROL lr = 0) 

- 

« 

• 

0 

0 


ASR, LSR. 

ROXR 

• 

* 

• 

0 

? 

C=Dr-i 

ASR. LSR lr = 0) 

- 

* 

* 

0 

0 


ROXR lr = 0) 

- 

« 

» 

0 

? 

C=X 

ROR 

- 

« 

• 

0 

? 

C=Dr-1 

ROR lr = 0) 

- 

« 

* 

0 

0 



- Not affected 

Sm 

Source Operand — 

U Undefined 

? Other - see Special Definition 

Dm 

most significant bit 
Destination operand - 

'General Case: 

Rm 

most significant bit 
Result operand - 

X = C 

N=Rm 

n 

most significant bit 
bit number 

Z=Rm....-R0 

r 

shift count 


Trace Mode 


Supervisor 

State 


Interrupt 

Mask 


Condition 

Codes 


{ Extend 
Negative 
Zero 
Overflow 
Carry 


System Byte User Byte 


^5 13 10 8^ 4 


> 


V 

c 


} 


Condition Codes: 
vvhere: 


X N Z V C 

r I I 1 I I 


h’ (negative) 
Z (zero) 

V (overflow) 

C (carry) 

X (extend) 


Set if the most significant bit of the result is set. Cleared otherwise. 
Set if the result equals zero. Cleared otherwise. 

Set if there was an arithmetic overflow. This implies that the result is 
not representable in the operand size. Cleared otherwise. 

Set if a carry is ger.erated out of the most significant bit of the 
operands for an addition. Also set if a borrow is generated in a subtrac¬ 
tion. Cleared otherwise. 

Transparent to data movement. When affected, it is set the same as 
the C bit. 


The nctational convention that appears in the representation of the condition code 
rec ster is; 


• set according to the result of the operation 
— net affected by the operation 
0 cleared 
1 set 

LI undefined after the operation 


Figure 1*3. Status Register 
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